MS-DOS Messages 


This chapter lists many of the commonly generated messages you 
might see while working at your computer. The messages are boldface 
and listed alphabetically. An explanation follows each message. Some- 
times you are given a reason for why you are seeing that message and 
what you can do to successfully complete the procedure you want. The 
word(s) at the beginning of the explanation, preceding the colon, indi- 
cate which program you were trying to execute when you received the 
message. 


Some error messages are generated by a command program that re- 
sides in both I mode and V mode. Although the two command pro- 
grams are different for each mode, you resolve the error in the same 
manner (independent of which mode you are in). For ease of refer- 
ence, the cause of an error message is listed “generically” instead of by 
mode. For example, error messages shown to be generated by: 


COMMAND.COM are generated by ICOMMAND.COM. if 
you are in I mode or VCOMMAND.COM 
if you are in V mode. 


CONFIG.SYS are generated by ICONFIG.SYS in I mode 
or by VCONFIG.SYS if you are in V 
mode. 


DOS.SYS or MS-DOS are generated by IDOS.SYS in I mode or 
by VDOS.SYS if you are in V mode. 


If a message pertains to only one mode, there is an explanation in the 
text following that message. 
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When MS-DOS encounters a problem, it displays an error message on 
the screen. Different error messages are displayed for different types of 
errors. Error messages are displayed in situations like these: 


> You have entered a command that MS-DOS does not recognize. 


> You have misspelled a filename, or you have entered an incorrect 
drive name. 


> You have inserted a diskette that does not contain the file or pro- 
gram that MS-DOS is looking for. 


If you get a floppy disk error when you try to load MS-DOS from 
diskette, remove the diskette to escape from the error situation. Check 
that the diskette is a system diskette and that it is not write-protected. 
Try inserting it again or use another system diskette. 


If you see the word ‘“‘filename” or “‘xxxx” in brackets or parentheses in 
one of the messages, it means that the message you see on your screen 
contains the specific filename or number(s) that are pertinent to the 
operation you are attempting. 


°C 
MS-DOS: MS-DOS has detected a CTRL-C (03H) from the console 
device. 

Abort edit (Y/N)? 


EDLIN: This message is displayed when you choose the Q (Quit) 
command in EDLIN. The Quit command exits the editing session 
without saving any editing changes. Specify Y for yes or N for no. 


Abort, Retry, Ignore? 


COMMAND, MS-DOS: If a disk or device error occurs at any time 
during a command or program, MS-DOS returns this message and 
asks you to abort the command or program, retry it, or ignore the 
error. 
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All files cancelled by operator 
PRINT: This message is displayed when you specify the /T switch 
with the PRINT command. 

All specified files are contiguous 
CHKDSK: All files are allocated contiguously on the disk without 
fragmentation. 

Allocation error for file (filename) 


CHKDSK: The named file had a data block allocated to it that does 
not exist (that is, a data block number larger than the largest possi- 
ble block number). CHKDSK truncates the file short of the bad 
block. 

Allocation error in file, size adjusted 
CHKDSK: An invalid sector number was found in the FAT. The 
file was truncated at the end of the last valid sector. 

Are you sure (Y/N)? 


COMMAND: MS-DOS displays this message if you try to delete *.* 
(all files in the current directory) or if you try to delete a directory 
(DEL directoryname). Specify Y (for Yes) or N (for No). 


Bad call format reading drive (x:) 


Device error: See Appendix B. 


Bad call format writing drive (x:) 


Device error: See Appendix B. 


Bad command error reading drive (x:) 


Device error: See Appendix B. 


Bad command error writing drive (x:) 


Device error: See Appendix B. 
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Bad command or file name 


COMMAND: The command processor cannot find the file you 
asked it to run. You either mistyped the filename or the file does 
not exist on the disk. Check to see that you are in the correct direc- 
tory and that you have specified the path correctly. 


Bad destination (must be a drive). 


RETROSYS: You have not specified the destination drive in correct 
notation, d:. 


Bad DISKCOPY command 


DISKCOPY: You entered the command incorrectly; retype the 
command. 


BAD MEDIA. PRESS RETURN KEY TO START OVER OR ALT- 
C TO EXIT. 


SDCOPY: Utility encountered a bad sector while reading or writing 
a diskette. Reformat or replace the diskette. 


Bad or missing (filename) 


MS-DOS: You specified an invalid device in the CONFIG.SYS file. 
Check the accuracy of the DEVICE statement in the CONFIG.SYS 
file. 


Bad or missing Command Interpreter 


MS-DOS: MS-DOS either cannot find or cannot read the 
COMMAND.COM file on the disk; either the file is missing from 
the root directory, or the file is invalid. Restart the system, or copy 
COMMAND.COM from your system disk onto the disk that you 
use to start MS-DOS. You can also receive this message if 
COMMAND.COM has been moved from the directory it was origi- 
nally in when you started MS-DOS. When MS-DOS cannot find or 
read the command interpreter specified in CONFIG.SYS, MS-DOS 
defaults to either A.ICOMMAND.COM or A:VCOMMAND.COM. 
You should always load the correct version of COMMAND.COM. 
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Bad parameter on command line. 


RETROSYS: You have used an invalid parameter on the command 
line. Correct the command. You might have not specified a parame- 
ter, or you might have specified an invalid drive, an invalid destina- 
tion, or too many parameters. 

Bad source (must be drive or file name). 
RETROSYS: You have not specified the source drive in correct 
notation, d: or [path]filename.ext. 

Bad unit error reading drive (x:) 


Device error: See Appendix B. 


Bad unit error writing drive (x:) 


Device error: See Appendix B. 


Bad volume ID 
COMMAND, DIR, VOL: You tried to list the directory on a disk 
with a bad Volume ID. 

Batch file missing 


COMMAND: MS-DOS cannot locate the batch file as specified in 
the CONFIG.SYS file. You have tried to execute a batch file from 
another batch file, but MS-DOS cannot find the batch file as 
specified. 


BREAK is off (or on) 
BREAK, COMMAND: This message tells you the current setting of 
BREAK. 

Cannot CHDIR to (filename) - tree past this point not processed 


CHKDSK: CHKDSK is traversing the tree structure of the directory 
and is unable to proceed to the specified directory. Subdirectories 
beneath this directory are not verified. 
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Cannot CHDIR to root 
Processing cannot continue 


CHKDSK: CHKDSK is traversing the tree structure of the directory 
and is unable to return to the root directory. CHKDSK cannot con- 
tinue checking the remaining subdirectories to the root. 

Cannot do binary reads from a device 


COMMAND: This message appears during COPY command pro- 
cessing. The COPY cannot be done in binary mode when you are 
copying from a device. Remove the /B switch or specify an ASCII 
copy with the /A switch. 

Cannot edit .BAK file—rename file 


EDLIN: You attempted to edit a backup copy created by EDLIN. 
Either rename the file or copy the .BAK file and give it a different 
extension. 

CANNOT FORMAT TRACK 
FORMAT: You might have a bad diskette. Run FORMAT again. If 
the error persists, discard the diskette. 

Cannot open (filename) 
PRINT: Either MS-DOS cannot find the specified file to print or the 
file does not exist. Check the command for a valid filename. 

CANNOT READ TRACK 
DISKCOPY: You might have a bad diskette. Run the program 
again. If the error persists, discard the diskette. 

Cannot recover . entry, processing continued 


CHKDSK: The . entry (current directory) is defective. 


Cannot recover .. entry 


CHKDSK: The .. entry (parent directory) is defective. 
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CANNOT SIZE TRACK 


DISKCOPY, FORMAT: You might have a bad diskette. Run the 
program again. If the error persists, discard the diskette. 


Cannot write label on drive 


RETROSYS: The diskette is write-protected, or you might have a 
bad diskette. Remove the write-protect tab, or insert a different 
diskette. 


CHDIR .. failed, trying alternate method 


CHKDSK: In traveling the tree structure, CHKDSK was not able to 
return to a parent directory. It will try to return to that directory by 
starting over at the root and traveling down. 


CLOSE DRIVE DOOR 


SDCOPY: The drive door was open during an attempted read or 
write of sector. 


Command not found 


COMMAND: You typed an incorrect command or an invalid de- 
limiter, parameter, or filename. Retype the command or filename 
correctly. 


Content of destination lost before copy 


COPY: A file to be used as a source file to the COPY command has 
been overwritten before completion of the copy. During file con- 
catenation (COPY with the + parameter), MS-DOS found a source 
filename with the same name as the destination filename. MS-DOS 
skips the source file and displays this message. For example, if you 
enter this command, MS-DOS destroys FILE2 before it can be 
copied: 


copy file1 + file2 file2(cr) 
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Convert lost chains to files (Y/N)? 


CHKDSK: If you respond Y to this prompt, CHKDSK recovers the 
lost blocks it found when checking the disk. CHKDSK creates a 
directory entry and a file for you with the filename FILEnnnn. If 
you respond N, CHKDSK frees the lost blocks so they can be real- 
located. If you did not specify the /F switch in the command line, 
you can still receive this message, but CHKDSK will not be able to 
convert the lost chains. 


Copy aborted at track nn 
DISKCOPY: The diskette might have a bad track, and the program 
is unable to continue. Run the program again, or try moving to 
another drive. If the error persists, discard the diskette. 

Copy another (Y/N)? 
DISKCOPY: Respond Y if you want to copy another diskette. 
Respond N if you do not want to copy another diskette. 

Copy complete 
DISKCOPY: DISKCOPY has completed processing. 


Copy completed. 
RETROSYS: This message appears when your system files are suc- 
cessfully copied to the destination drive. 

Copy failed. 
RETROSYS: This message appears when your system files have not 
been successfully copied to the destination drive. 

Copy not completed 
DISKCOPY: DISKCOPY could not copy the entire disk. 
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Copy to B: (FLOPPY). Press space bar when ready. 


RETROSYS: You see this message when you are using a dual- 
floppy drive system and you have specified only the source of the 
system files in the command line. Press the space bar to start the 
system copy. 


Copying... 


DISKCOPY: This message indicates that DISKCOPY is copying a 
diskette. 


Copying configuration file: 


RETROSYS: You see this message as RETROSYS copies the 
CONFIG.SYS and CONFIG.BAT files. 


Copying device drivers: 


RETROSYS: You see this message on the screen as RETROSYS 
copies the device drivers to the specified drive. 


Copying system files: 


RETROSYS: You see this message as the system files are being 
copied. 


<CR> for retry, or new drive = 


COMMAND: COMMAND.COM must be reloaded, but the PlusPC 
cannot find the file. Insert a diskette with COMMAND.COM in the 
current drive and press Return, or enter the path to the directory 
where COMMAND.COM 1s located and press Return. 


Current date is (mm-dd-yy) 


COMMAND, DATE: This message is displayed in response to the 
DATE command. If the date is correct, press Return; if not, enter a 
new date. 
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Current time is (hh:mm:ss:hh) 


COMMAND, TIME: This message is displayed in response to the 
TIME command. If the time is correct, press Return; if not, enter 
the correct time. 


Data error reading drive (x:) 


Device error: See Appendix B. 


Data error writing drive (x:) 


Device error: See Appendix B. 


Destination drive? Press RETURN to end. 
RETROSYS: After designating the destination drive letter, press the 
Return key to complete this prompt. 
Destination FAT read failed. 
RETROSYS: There is a disk read error. Remove the diskette and 
reinsert it in the drive and try again, or use a different diskette. 
Directory error - file: (filename) 
CHKDSK: No valid data blocks are allocated to the named file. 
CHKDSK deletes the file. 
Directory is totally empty, no . or .. files 


CHKDSK: The specified directory does not contain references to 
current and parent directories. Delete the specified directory and 
recreate it. 


Disk error reading drive (x:) 


Device error: See Appendix B. 


Disk error reading FAT (x) 


CHKDSK: One of your File Allocation Tables has a defective sector 
in it. MS-DOS automatically uses the other FAT, but it is a good 
idea to copy all your files to another disk. 
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DISK error while reading drive A 
Abort, Ignore, Retry? 


DISKCOPY: MS-DOS encountered disk errors during DISKCOPY 
processing. Refer to Appendix B, “‘Device I/O Errors,” for more in- 
formation on this message. 


Disk error writing drive (x:) 


Device error: See Appendix B. 


Disk error writing FAT (x:) 


CHKDSK: One of your File Allocation Tables has a defective sector 
in it. MS-DOS automatically uses the other FAT. It is a good idea to 
copy all your files onto another disk. 


Disk full—write not completed 


EDLIN: You gave the END command, but the disk did not contain 
enough free space for the file. EDLIN aborted the E command and 
returned you to the MS-DOS prompt. You should remove some 
files from the disk that is full, or copy the file to another disk. Part 
of the file might have been written to disk and saved. Delete the 
saved portion and restart the editing session. The file will not be 
available after this error. 


Disk not initialized 


CHKDSK: No directory or file allocation table was found. If files 
exist on the disk, and the disk has been physically harmed, you 
might still be able to transfer files from this disk to recover data. 


Disk unsuitable for system drive 


FORMAT: FORMAT detected a bad track on the disk where sys- 
tem files should reside. Use another disk for your system files and 
throw away the bad disk. - 
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Disks must be the same size 


DISKCOPY: You cannot copy the contents of a disk with a 
different format using DISKCOPY. Use the COPY command to 
copy files onto the disk. 


Divide overflow 


MS-DOS: The 8088 has set the divide overflow flag which is usually 
caused by division by zero. MS-DOS has received an overflow inter- 
rupt (or a rampant program has simulated the interrupt). Re- 
start your system. 
(.)(..) Does not exist 
CHKDSK: Either the . or .. directory entry 1s invalid. 
DOUBLE-SIDED SOURCE DISK CANNOT BE COPIED TO 
SINGLE-SIDED DESTINATION. 


SDCOPY: You have tried to copy a double-sided diskette to a 
single-sided diskette. SDCOPY will again prompt you to insert a 
destination diskette. Replace the destination diskette with a double- 
sided one. 


Drive = n Track = n Error = MM 

Abort, Retry, Ignore? 
Type A (to abort) the command, I (to ignore) the error, or R (to 
retry) the command that generated this error. 

DRIVE DOOR OPENED 
DISKCOPY, FORMAT: Close the drive door and restart the pro- 
gram. 

Drive not ready 


PRINT: During a print operation, you removed the diskette con- 
taining the file being printed. 
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Duplicate file name or File not found 


COMMAND, RENAME: You have tried to rename a file to a 
filename that already exists, or the name you specified could not be 
found. 

ECHO is off (or on) 


COMMAND: This message tells you the current status of ECHO. 


End of input file 


EDLIN: The entire file was read into memory. If the file is read in 
sections, this message indicates that the last section of the file is in 
memory. 


Enter new date: 
COMMAND, DATE: You must respond to this prompt when you 
start MS-DOS. Enter the date in the mm/dd/yy format. 

Enter new time: 
COMMAND, TIME: You must respond to this prompt when you 
start MS-DOS. Enter the time in the hh:mm:ss format. 

Enter new volume ID: 


COMMAND, VOL: Respond to this prompt by entering a volume 
ID for the disk. A Volume ID can be up to eleven characters long, 
using valid characters for filenames. You see this message only when 
you use the /C switch with VOL. 


Entry error 


FOR: The %% parameters specified in the FOR command must 
match: FOR %%A IN (%%02 %%03 %%04) DO MKDIR %%A. 


EDLIN: The last command you entered contained a syntax error. 
Retype the command with the correct syntax and press Return. 
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Entry has a bad attribute (or link or size) 


CHKDSK: This message can be preceded by one or two periods 
indicating which subdirectory is invalid. If you have specified the /F 
switch, CHKDSK attempts to correct the error. 


Error in .EXE file 
COMMAND: The .EXE file you tried to load has an invalid inter- 
nal format. 

(type of error) error reading file 
Device error: See Appendix B. 

ERROR WHILE READING ON DRIVE x 

Abort,Ignore, Retry: 


Type A (abort), I (ignore), or R (retry). Retry the operation before 
ignoring or terminating (aborting) the program. Ignoring the error 
could result in bad data. Check the resulting file carefully. 


ERROR WHILE WRITING ON DRIVE x 
Abort,Ignore,Retry: 


Type A (abort), I (ignore), or R (retry). Retry the operation before 
ignoring or terminating (aborting) the program. Ignoring the error 
could result in bad data. Check the resulting file carefully. 


Error writing to device 
COMMAND: You tried to send too much data to a device. MS- 
DOS was unable to write the data to the specified device. 


Errors found, F parameter not specified 


CHKDSK: Corrections will not be written to disk. CHK DSK found 
errors on the disk. If you have not specified the /F switch, 
CHKDSK continues printing messages, but does not correct the 
errors. 
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Errors on list device indicate that it might be offline. Please check it. 
PRINT: Your printer is off-line. Check that your printer is turned 
on, that there is paper in it, and that the cables are connected. 

EXEC failure 


COMMAND: Either MS-DOS found an error when reading a com- 
mand or the FILES statement in the CONFIG.SYS file is set too 
low. Increase the value and reboot MS-DOS. 


File allocation table bad 
COMMAND: The disk might be defective. Run CHKDSK to check 
the disk. 

File allocation table bad drive (x:) 
CHKDSK: The disk might be defective. Run CHKDSK to check 
the disk. 

FILE ALLOCATION TABLE BAD FOR DRIVE x 


Check that the diskette is formatted. The message indicates that the 
copy in memory of one of the allocation tables has pointers to 
nonexistent blocks. 


File cannot be converted 


EXE2BIN: The input file is not in the correct format. CS:IP does 
not meet the criteria specified, or it meets the .COM file criterion 
but has segment fixups. This message is also displayed if the file is 
not a valid executable file. 


File cannot be copied onto itself 
0 File(s) copied 


COMMAND, COPY: The source filename you specified is the same 
as the destination filename. For example, you entered: 


copy file1 file1(cr) 
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The file copy must be renamed if it is on the same drive, or it must 
be on a different drive than the source file. 


File Creation Error 


SORT: You used the directional output symbol (>) in the SORT 
command, but did not specify an output source. Or, MS-DOS could 
not complete the copy of a fixed disk volume to a diskette because 
the volume directory was larger than the diskette directory. 


File creation error 


CHKDSK, COMMAND, EXE2BIN: With CHKDSK, you tried to 
add a new filename or replace a file that already exists in the direc- 
tory. If the file already exists, it is a read-only file and cannot be 
replaced. Run CHKDSK on the disk to determine the cause of the 
error. With EXE2BIN, EXE2BIN cannot create the output file. Run 
CHKDSK to determine if the directory is full, or if some other con- 
dition caused the error. 


File size error for file (filename) 
CHKDSK: The size of the file in its directory differs from its actual 
size. CHKDSK adjusts the directory to indicate the actual file size. 
The amount of useful data might be less than the size shown 
because the last data block might not be used fully. 
(filename) contains non-contiguous blocks 
CHKDSK: The filename specified is not allocated contiguously on 
the disk. If you specify the /F switch, CHKDSK can fix this error. 
(filename) file not found 
PRINT: You switched disks while a file was queued up, but before 
it started to print. Reissue the PRINT command for that filename. 
(filename) is cross linked on cluster 


CHKDSK: Make a copy of the file you want to keep, and then 
delete both files that are cross linked. 
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(filename) is currently being printed 


PRINT: The filename specified is being printed. 


(filename) is in queue 


PRINT: The filename specified is waiting to be printed. 


Filename must be specified 


EDLIN: You did not specify a filename when you started EDLIN. 


File not found 


COMMAND, EXE2BIN, FIND, EDLIN, RECOVER: MS-DOS 
cannot find the file you specified. Check to see that the pathname is 
accurate and that the file exists in the directory you specified. 


Files cross-linked: (filename) and (filename) 


CHKDSK: The same data block is allocated to both files. CHKDSK 
does not try to correct this. To correct the problem, first COPY both 
files; then delete the originals. Review each file for validity and edit 
as necessary. 


File not found xxxx.xxx 


FIND: where x is a character in the filename. You entered the 
FIND command for a string of characters in a file. MS-DOS could 
not locate the file, because the file is not in your current directory. 
You need to simplify a path through the directory hierarchy to the 
subdirectory containing the correct filename. 


First cluster number is invalid, entry truncated 


CHKDSK: The file directory entry contains an invalid pointer to 
the data area. If you specified the /F switch, the file is truncated to a 
zero-length file. 
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Fixups needed - base segment (hex:) 


EXE2BIN: The source (.EXE) file contained information indicating 
that a load segment is required for the file. Specify the absolute seg- 
ment address at which the finished module is to be located. 


FOR cannot be nested 


COMMAND: Nesting FOR statements is not allowed in a batch 
file. 


Format aborted at track nn 


FORMAT: The diskette has a bad track, and the program is unable 
to continue. Run the program again, or try moving to another drive. 
If the error persists, discard the diskette. 


Format another (Y/N)? 


FORMAT: Type Y (for Yes) to format another disk. Type N (for 
No) if you do not want to format another disk. If you accidentally 
type Y, you can abort the format process by typing CTRL-BREAK 
in response to the “Strike any key to begin formatting” message. 


Format failure 


FORMAT: MS-DOS could not format the diskette. This message is 
always displayed with an explanation as to why MS-DOS could not 
format the diskette. 


Incorrect MS-DOS version 


ASSIGN, CHKDSK, EDLIN, FIND, FORMAT, MORE, PRINT, 
RECOVER, SORT: Many utilities cannot run on earlier versions of 
MS-DOS. Some of the utilities can run only under the version of 
MS-DOS for which they were configured. Do not use an older ver- 
sion of CHKDSK because it can delete files. 


Insert diskette for drive (x:) and strike any key when ready 


MS-DOS: This message appears when MS-DOS is copying and for- 
matting. You should insert a disk in the appropriate drive and press 
any alphanumeric key to begin processing. 
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Insert diskette with batch file and press any key when ready 


COMMAND: The disk containing the batch file in progress is no 
longer in the drive in which you started it. Reinsert the disk that 
contains the batch file in the appropriate drive, or press CTRL-C. 


Insert formatted target diskette into drive (x:) 


DISKCOPY: DISKCOPY is ready for a disk in the destination 
drive. 


Insert new diskette for drive (x:) and strike any key when ready 


FORMAT: Insert a blank disk into the appropriate drive and press 
any alphanumeric key to begin formatting. CAUTION: If there is 
any data on the disk, it will be destroyed by the format process. 


Insert source diskette into drive (x:) 


DISKCOPY: Insert the disk to be copied into the specified drive. 


Insert target diskette into drive (x:) 


DISKCOPY: You are running DISKCOPY and your source and 
destination drives are the same. Reinsert the destination disk into 
the specified drive. 


Insufficient disk space 


COMMAND, EXE2BIN, SORT: The disk is full. It does not con- 
tain enough room to perform the specified operation. MS-DOS 
copied as many files as possible, and there are more files to be 
copied. Remove the diskette that is full, insert another formatted 
diskette, and copy the remaining files. 


Insufficient memory. 


CHKDSK, EDLIN, EXE2BIN, SORT, RETROSYS: There is not 
enough free memory to perform the specified operation. Reboot and 
try again, or add more RAM. 
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Insufficient room in root directory. Erase files in root and repeat 
CHKDSK 


CHKDSK: CHKDSK always recovers lost files into the root direc- 
tory. In this case, your root directory is full. Delete some files in 
your root directory to make room for the lost files. 


Intermediate file error during pipe 


COMMAND: The pipe operation makes use of temporary files on 
the disk which will automatically be deleted after the piping process 
is complete. An error has occurred in one of these files. 


Invalid baud rate 
MODE: You specified an invalid baud rate. 


Invalid characters in volume label 


FORMAT: The volume label should contain only up to 11 alpha- 
numeric characters. 


Invalid characters per line 


MODE: You specified invalid characters in this line. 


Invalid COMMAND.COM 
Insert COMMAND.COM disk in drive (x:) and strike any key when 
ready 


COMMAND: MS-DOS needs to reload the ICOMMAND.COM or 
VCOMMAND.COM file from disk; however, MS-DOS cannot find 
ICOMMAND.COM or VCOMMAND.COM on the disk, or the 
copy found is invalid. Insert a disk into the specified drive which 
contains a copy of ICOMMAND.COM or VCOMMAND.COM 
identical to the version on the disk with which you started MS- 
DOS. 
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Invalid country code 


MS-DOS: You have specified a country number in your 
CONFIG.SYS file which is not 1n the table of files configured in this 
implementation of MS-DOS. Country codes must be in the range 
1-99. Consult the documentation on CONFIG.SYS for more infor- 
mation on supported countries. 


Invalid current directory 
CHKDSK: Your disk is bad. Replace the disk or make another 
copy from your backup system disk. 

Invalid date 
COMMAND, DATE: You specified an invalid date in response to 
the date prompt when starting MS-DOS. 

Invalid device 
COMMAND: The device specified was not CON, NUL, AUX, 
LST, or PRN. 

Invalid device name 


MODE: You specified an invalid device name. 


Invalid directory 
COMMAND: The directory you specified either does not exist or is 
invalid. Check to see that you entered the directory name correctly. 
Invalid drive in search path 
COMMAND: One of the drives specified in the last PATH or SET 
PATH commands does not exist. 
Invalid drive or file name 
EDLIN, RECOVER: Specify a valid drive or a valid filename. 
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Invalid drive specification 


CHKDSK, COMMAND, DISKCOPY, FORMAT: Specify a valid 
drive. 


Invalid lines per inch 


MODE: You specified an incorrect number of lines per inch. See 
MODE in Chapter 6.4 for information on how to specify this 
parameter. 


Invalid number of data bits 


MODE: You specified an invalid number of data bits. Se MODE 
in Chapter 6.4 for information on how to specify this parameter. 


Invalid number of parameters 


COMMAND, FIND, MODE, RECOVER: You have specified the 
wrong number of options in the command line, or you have put an 
incorrect number or spaces between parameters. 


Invalid number of stop bits 


MODE: You specified an invalid number of stop bits. Se MODE 
in Chapter 6.4 for information on how to specify this parameter. 


Invalid parameter 


ASSIGN, CHKDSK, COMMAND, EDLIN, FIND, FORMAT, 
MODE, PRINT: One of the switches that you have specified is 
wrong, or you have put an incorrect number or spaces between 
parameters. In ASSIGN, this message is generated when you specify 
a drive letter that is not supported by MS-DOS. With MODE, you 
might have specified a parameter that is not supported in V mode. 


Invalid parity 


MODE: You specified an invalid parity value. See MODE in 
Chapter 6.4 for information on how to specify this parameter. 
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Invalid path or file name 
COMMAND: Specify a valid pathname or filename to the COPY, 
DEL, or TYPE command. 

Invalid path, not directory, or directory not empty 
COMMAND, RMDIR: You are unable to remove the directory 
requested for one of the specified reasons. 

Invalid screen mode 
MODE: You specified an invalid screen mode. The sector size is too 
large in the file. 

Invalid sub-directory entry 


CHKDSK: The subdirectory that you specified either does not exist 
or is invalid. Check to see that you entered the subdirectory name 
correctly. 

Invalid time 


COMMAND, TIME: You specified an invalid time in response to 
the time prompt when starting MS-DOS. 

Label not found 
COMMAND): There is a GOTO command to a nonexistent label in 
a batch file. 

Line too long 


EDLIN: During a Replace command, the string given as the 
replacement caused the line to expand beyond 253 characters. 
Divide the long line into two lines and retry the Replace command. 


List output is not assigned to a device 


PRINT: When you first run PRINT, it asks you what device you 
want to specify as a print spooler. This message appears if PRINT is 
set up for a nonexistent device. 
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Memory allocation error. Cannot load COMMAND, system halted 


COMMAND: Restart MS-DOS. The program you just ran might 
have been written using poor memory allocation techniques that are 
not acceptable in this version of MS-DOS. If this error persists, 
make a new copy of the MS-DOS disk from your backup copy of 
the system disk. 

--More-- 


MORE: Press the Space bar to view more of the file or directory. 


Must specify destination line number 
EDLIN: You must specify a destination line number when you are 
copying and inserting lines with EDLIN. 

Must specify ON or OFF 
BREAK, COMMAND, VERIFY: The command requires an argu- 
ment, either ON or OFF. 

Name of list device [PRN]: 


PRINT: This prompt appears when you run PRINT for the first 
time in any computer session. You can specify any valid device 
which then becomes the PRINT output device. 


New file 


EDLIN: This message is printed if EDLIN does not find a file with 
the name you specified. If you are creating a new file, ignore this 
message. If you do not intend to create a new file, check to see that 
you correctly typed the filename of the file you want to edit. 


NO DISKETTE OR BAD TRACK 


FORMAT: If you have not inserted a diskette in the drive to be for- 
matted, do so and restart the program. If the drive contains a 
diskette, take it out and retry with another diskette. 
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No files match (d:filename) 
PRINT: A filespec was given for files to add to the queue, but no 
files match the specification. 

No free file handles 
COMMAND: Restart MS-DOS. If this message persists, increase the 
FILES parameter in the CONFIG.SYS file. 

No paper error writing device (dev) 


Device error: See Appendix B. 


No path 
COMMAND, PATH: There is no current command search path. 


No room in directory for file 
EDLIN: You have tried to save a file to the root directory but it is 
full. Subdirectories are not limited in size as is the root directory. 
No room in environment for LOAD 


COMMAND: There are too many values set in the current environ- 
ment to load a program. Use the SET command to set some of the 
values to null strings. 

Non-MS-DOS disk error reading drive (x) 


Device error: See Appendix B. 


Not enough room to merge the entire file 


EDLIN: There was not enough room in memory to hold the file 
during a Transfer command. You must free some memory by writ- 
ing some files to disk or deleting some files before you can transfer 
this file. 
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Not found 


EDLIN: You have specified a Search or a Replace command that 
was unable to find a further occurrence of the specified Search or 
Replace string. 

Not ready error reading drive (x:) 


Device error: See Appendix B. 


Not ready error writing drive (x:) 


Device error: See Appendix B. 


O.K.? 
EDLIN: This prompt occurs during Search and Replace command 
processing. If you press any key except Y or Return, the search or 
replace continues. 

Opening system files: 
RETROSYS: You see this message when the system files are being 
opened on the source diskette. 

Operating system mismatch 
RETROSYS: This message appears when you try to copy a different 
version of MS-DOS than RETROSYS is configured for. 

Operating system version mismatch 


FORMAT: The operating system being used is not compatible with 
the version of FORMAT being used. Use the correct version of the 
program or load the correct operating system. 


O/S must be MSDOS 2.0 or above. 


RETROSYS: You have attempted to copy a version of MS-DOS 
that is older than version 2.0. RETROSYS runs only under MS- 
DOS version 2.X or above. 
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Out of environment space 
COMMAND: There is not enough room in the program environ- 
ment to accept more data. 

Path specified is too long for environment 


COMMAND: The path specified in a command-line parameter or 
argument is too long to fit into the environment. Use shorter sub- 
directory names, fewer levels of subdirectories, or make more room 
in the environment by removing some set values. (See the SET 
command in Chapter 6.4.) 


Preparing destination 
RETROSYS: You see this message when the system files are being 
written to the destination diskette. 

Press any key to begin formatting (x:) 


FORMAT: This prompt is issued before you format a disk. Press 
any alphanumeric key to begin formatting. To discontinue this 
operation, press CTRL-BREAK. 

Press any key to begin recovery of the (xxx) file(s) on drive (x:) 


RECOVER: This prompt is issued before you recover a disk or file. 
Press any alphanumeric key to begin recovering. To discontinue this 
operation, press CTRL-BREAK. 

Press any key when ready 


DISKCOPY: This prompt occurs when you are copying disks. 
When you have inserted the disks into the appropriate drives, press 
any alphanumeric key to begin copying the disk. To discontinue 
this operation, press CTRL-BREAK. 

PRINT queue is empty 


PRINT: There are no files waiting to be printed. 


MS-DOS Messages 7-27 


PRINT queue is full 


PRINT: There is only room for 10 files in the list of files waiting to 
be printed. 


Printer error. 


MODE: The print device generated an error when output was sent 
to it. 


Probable non-DOS disk 
Continue (Y/N)? 


CHKDSK: The disk you are using is not recognized by this version 
of MS-DOS. The disk either was created by another system with a 
format that is not supported on this version of MS-DOS or is not an 
MS-DOS disk. Do not continue processing if CHKDSK has 
returned this message for a floppy disk. If this message is returned 
for a fixed disk, the information describing the disk characteristics 
to MS-DOS has been destroyed. In this case, continue CHKDSK 
processing. You will probably have to set up your fixed disk again. 


Processing cannot continue 


CHKDSK: There is not enough memory free in your machine to 
process CHKDSK for this disk. You must obtain more memory to 
run CHKDSK. 


Program too big to fit in memory 


COMMAND: You must acquire more memory to run your applica- 
tion. Some applications you have run might still be using some 
memory. You can try to restart MS-DOS; however, if you receive 
this message again, you must acquire more memory. 


Read error: D = nn, T= nn, S= nn, E=nn 
CANNOT READ TRACK 


DISKCOPY, FORMAT: Retry the program; discard the diskette if 
the error persists. (D stands for drive, T for track, S for sector, and E 
for error code.) 
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Read fault error reading drive (x:) 


Device error: See Appendix B. 


Resident part of PRINT installed 


PRINT: This is the first message that MS-DOS displays when you 
issue the PRINT command. It means that available memory has 
been reduced by several thousand bytes to-process the PRINT com- 
mand concurrent with other processes. 


Sector not found error reading drive (x:) 


Device error: See Appendix B. 


Sector not found error writing drive (x:) 


Device error: See Appendix B. 


Sector size too large in file (filename) 


Device error: The specified device driver loaded by CONFIG.SYS 
uses a sector size larger than that of any other device driver on the 
system. You cannot run this device driver. 


Sector write error: D = nn, T = nn, S = nn, E = nn 
CANNOT WRITE DISK LABEL 


DISKCOPY, FORMAT: The program is unable to write the disk 
label to the diskette. The disk label is part of the internal identi- 
fication system for diskettes. The location and type of the problem 
are indicated by the drive, track, sector, and error code numbers. 


Seek error reading drive (x:) 


Device error: See Appendix B. 


Seek error writing drive (x:) 


Device error: See Appendix B. 
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Soft format error: D = nn, T = nn, S= nn, E = nn 


FORMAT: A soft format error has occurred. The drive, track, sec- 
tor, and error code numbers are indicated. If there are more than 9 
soft errors on a track, the program aborts. Soft errors in moderate 
numbers do not hurt diskette performance. 


Source and destination drives must differ 


RETROSYS: You cannot specify the same source and destination 
drives. You cannot copy the system onto itself. 


Source and target diskettes are not the same format. Cannot do the copy. 


DISKCOPY: You must have the same size and kind of disks to run 
DISKCOPY. You cannot copy from a single-sided disk to a 
double-sided disk. Reformat the target disk so that it is the same for- 
mat as the source disk. 


Specified COMMAND search directory bad 


MS-DOS: The SHELL statement in the CONFIG.SYS file is in- 
correct. The location that you have told MS-DOS to find 
COMMAND.COM does not exist, COMMAND.COM is not in that 
place, or you have specified the wrong name. 


specify SOURCE of system files. 
RETROSYS: You have not specified the source of the system files, 
so MS-DOS cannot find them. 


Strike a key when ready... 


COMMAND: This prompt occurs during command processing and 
is usually accompanied by another message. This message is also 
displayed if you have inserted a PAUSE statement in a batch file. 
Usually, you are asked to insert disks into appropriate drives before 
this prompt. Press any key to begin command processing. 


Syntax error 


COMMAND, FIND: Make sure you typed the command correctly. 
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Terminate batch job (Y/N)? 


COMMAND: If you press CTRL-BREAK while in batch mode, 
MS-DOS asks you whether or not you want to end batch processing. 
Press Y to end processing; press N to continue the batch job. 


Track 0 bad - disk unusable 


FORMAT: FORMAT can accommodate for defective sectors on 
the disk except for those near the beginning. FORMAT cannot 
write the boot record. Use another disk. 

Unable to create directory 
COMMAND: MS-DOS could not create the directory you specified. 
You might have a file with the same name, or the disk might be full. 


Unrecognized command in CONFIG.SYS 


MS-DOS: There is an invalid statement in your ICONFIG.SYS or 
VCONFIG.SYS file. Check to see that you have not mistyped any 
statements in the ICONFIG.SYS or VCONFIG:SYS file. 


Unrecoverable error in directory 
Convert directory to file (Y/N)? 


CHKDSK: If you specified /F in the command line, you can 
respond Y to this prompt and CHKDSK will convert the bad direc- 
tory into a file. You can then fix the directory yourself or delete it. 
VERIFY is off (or on) 
COMMAND, VERIFY: This message tells you the current setting 
of VERIFY. 
Volume ID not changed—file of same name exists. 


COMMAND, VOL: The volume ID specified after a VOL /C com- 
mand is the same as a filename that already exists on the volume. 
Choose another name. 
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VOLUME IN DRIVE IS NONEXISTENT OR IS NOT A FLOPPY. 
SDCOPY: There is no floppy in the disk drive. 


Volume in drive (x:) has no label 


COMMAND, DIR, VOL: MS-DOS displays this message in 
response to the DIR or VOL command when you have not specified 
a volume label. 


Volume in drive (x:) is (volume ID) 
COMMAND: MS-DOS displays this message in response to the 
DIR or VOL command when you have specified a volume label. 
Volume label (11 characters, ENTER for none)? 


FORMAT, VOL: This message is displayed when you specify the /V 
switch in the FORMAT command or the /C switch in the VOL 
command. Specify a volume label or press Return to indicate that 
you do not want a volume label for this disk. 


Warning - directory full 
RECOVER: The root directory is too full for RECOVER process- 


ing. Delete some files in the root directory to free space. 


WARNING - DOUBLE-SIDED DESTINATION DISK WILL 
BECOME SINGLE-SIDED AS A RESULT OF THIS 
OPERATION. DO YOU WISH TO CONTINUE? (y/n) 


SDCOPY: You have tried to copy a single-sided diskette to a 
double-sided diskette. Type y for yes, or n for no. 


Warning: Read error in EXE file. 


EXE2BIN: The amount read was less than the size of the header. 
This is a warning message only. EXE2BIN will attempt to continue 
processing. 


Write fault error writing drive (x:) 


Device error: See Appendix B. 
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WRITE PROTECTED DISKETTE 


FORMAT: The diskette being formatted has a write-protect tab on 
it. Remove the tab and try again. CAUTION: Files auras on the 
diskette will be erased if you do this. 

Write protect error writing drive (x:) 


Device error: See Appendix B. 


Write protect violation 
FORMAT: The disk 1s write-protected. 


WRONG DESTINATION DISK 


SDCOPY: The current destination diskette is different from the ori- 
ginal one. This message appears in multiple insertions of the desti- 
nation diskette. Insert the correct destination diskette. 

Wrong destination label type 


RETROSYS: The PlusPC operating system can only be copied to a 
VICTOR-formatted diskette or a PlusPC-configured fixed (hard) 
disk. 

WRONG SOURCE DISK 


SDCOPY: The current source diskette is different from the original 
one. This message applies to multiple insertions of the source 
diskette. Insert the correct source diskette. 

(xxxx) of (xxxx) bytes recovered 
RECOVER: This message tells you how many bytes MS-DOS was 
able to recover of the disk or file. 

(filename) cancelled by operator 


PRINT: This message is printed on the printer when you specify the 
/T switch in the PRINT command. 


MS-DOS Messages 7-33 


The following messages are displayed when 
mands have completed processing. These are 
only. 


(xxxx) bytes available on disk 
CHKDSK, FORMAT 


(xxxx) bytes disk space freed 
CHKDSK 


(Xxxx) bytes disk space would be freed 
CHKDSK 


(xxxx) bytes free 
COMMAND 


(xxxx) bytes in (yyyy) directories 
CHKDSK 


(xxxx) bytes in (yyyy) hidden files 
CHKDSK 


(xxxx) bytes in (yyyy) recovered files 
CHKDSK 


(xxxx) bytes in (yyyy) user files 
CHKDSK 


(xxxx) bytes in bad sectors 
FORMAT 


(xxxx) bytes total disk space 
FORMAT 
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(xxxx) bytes total memory 
CHKDSK 


(xxxx) bytes used by system 
FORMAT 


(xxxx) bytes would be in (yyyy) recovered files 
CHKDSK 

(xxxx) file(s) 
COMMAND, DIR 


(xxxx) file(s) copied 
COMMAND, COPY 


(xxxx) file(s) recovered 
RECOVER 


(xxxx) lost clusters found in (xxxx) chains 
CHKDSK _ 


(filename) contains (xxxx) non-contiguous blocks 
CHKDSK 


(filename) has invalid cluster, file truncated 
CHKDSK 


Volume (filename) created (mm, dd, yyyy) 
CHKDSK 
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ASCII Character Codes 
ASCII Value Screen Code 
Decimal Hex Character Name Keystroke 
000 00 (null) NUL — 
001 01 © SOH CTRL-A 
002 02 @ STX CTRL-B 
003 03 ~ ETX CTRL-C 
004 04 @ EOT CTRL-D 
005 05 & ENQ CTRL-E 
006 06 & ACK CTRL-F 
007 07 (beep) BEL CTRL-G 
008 08 a BS CTRL-H 
009 09 (tab) HT CTRL-I 
010 0A (line feed) LF CTRL-J 
011 OB (home) VT CTRL-K 
a 012 0C (form feed) FF CTRL-L 
| 013 OD (carriage return) CR CTRL-M 
014 OE da SO CTRL-N 
015 OF xt SI CTRL-O 
016 10 Be DLE CTRL-P 
017 11 « DCI CTRL-Q 
018 12 t DC2 CTRL-R 
019 13 1! DC3 CTRL-S 
020 14 T DC4 CTRL-T 
021 15 § NAK CTRL-U 
022 16 _ SYN CTRL-V 
023 17 ¢ ETB CTRL-W 
024 18 4 CAN CTRL-X 
025 19 { EM CTRL-Y 
026 1A _ SUB CTRL-Z 
027 1B — ESC Escape Key 
028 1C (cursor right) FS 
~ 029 ID (cursor left) GS 
030 IE (cursor up) RS 
031 IF (cursor down) US 


ASCII Character Codes | A-| 


ASCII Value ASCII Value 


Screen Screen 
Decimal Hex Character Decimal Hex Character 

032 20 (space) 064 40 @ 
033 21 | 065 41 A 
034 22 . 066 42 B 
035 23 # 067 43 c 
036 24 $ 068 44 D 
037 25 % 069 45 E 
038 26 & 070 46 F 
039 27 : 071 47 G 
040 28 ( 072 48 H 
041 29 ) 073 49 I 
042 2A . 074 4A J 
043 2B + 075 4B K 
044 2C 076 AC L 
045 2D - 077 4D M 
046 2E 078 4E N 
047 2F j 079 4F O 
048 30 0 080 50 Pp 
049 31 1 081 51 Q 
050 32 2 082 52 R 
051 33 3 083 53 S 
052 34 4 084 ‘54 T 
053 35 5 085 55 U 
054 36 6 086 56 V 
055 37 7 087 57 W 
056 38 8 088 58 4 
057 39 9 089 59 Y 
058 3A 090 5A Z 
059 3B : 091 5B [ 
060 3C < 092 5C \ 
061 3D = 093 5D ] 
062 3E > 094 5E /\ 
063 3F ? 095 5F = 
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ASCII Value 


| Screen 
Decimal Hex Character 
224 EO a 
225 El B 
226 E2 [" 
22) E3 
228 F4 z 
229 E5 o 
230 E6 LU 
231 E7 ai 
232 E8 oo) 
233 E9 oe 
234 EA Q 
235 EB § 
236 EC 00 
237 ED © 
238 EE € 
239 EF N 
240 FO = 
241 FI + 
242 F2 > 
243 F3 < 
244 F4 " 
245 F5 J 
246 F6 + 
247 F7 oe 
248 F8 i 
249 F9 ° 
250 FA ° 
251 FB f 
252 FC n 
253 FD 2 
254 FE © a 
255 FF (blank ‘FF’) 
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Device I/O Errors 


If a disk or device error occurs during a command or program, MS- 
DOS displays an error message in the following format: 


<yyy> error <I/0O action> <device x> 


Abort, Ignore, Retry: 


In this message, < yyy > can be one of the following: 


Write protect error 
Bad unit error 

oa Not ready error 
Bad command error 
Data error 
Bad call format error 
Seek error 
Non-MS-DOS disk error 
Sector not found error 
No paper error 
Write fault error 
Read fault error 
Disk error 


The <I/O-action > can be either of the following: 


READING 
WRITING 


farm < device x > indicates the device or the drive on which the error has 
occurred. 
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“Abort, Ignore, Retry:” is the prompt that MS-DOS provides. MS- 
DOS waits for you to enter one of the following responses: 


» A for Abort. Abort ends the program requesting the disk read or 
write and you return to MS-DOS. 


> I for Ignore. Ignore tells MS-DOS to ignore the problem and to pre- 
tend the error did not occur. 


> R for Retry. Retry tells MS-DOS to repeat the operation. Use this 
response when you have corrected the error. For example, specify 
Retry if you have closed the drive door or removed a write-protect 
tab after getting a NOT READY or WRITE PROTECT error. 


Usually, you should attempt recovery in this order: First specify R to 
try again; if this is unsuccessful then specify A to end the program. At 
this point, you will probably want to try a new disk or investigate the 
problem. 


You may receive this error message which might be related to faulty 
disk read or write: 


FILE ALLOCATION TABLE BAD FOR DRIVE x 


This message means that the allocation table copy that resides in 
memory has pointers to nonexistent blocks. Perhaps your disk was for- 
matted incorrectly, or was not formatted at all. Run CHKDSK and 
this should help you define the problem. If this error persists, you can- 
not use the disk. Try using a freshly formatted disk. 
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ANSI Escape Sequences 


An ANSI escape sequence is a series of characters beginning with an 
escape character or keystroke that you can use to define functions to 
MS-DOS. With escape sequences, you can: 


> Reassign keys 

> Change graphics functions 

> Affect cursor movement 

There are two different ANSI programs for the two modes. To execute 


the correct version of ANSI when you are in I mode, enter the follow- 
ing command in the ICONFIG.SYS file, to load ANSI.SYS: 


DEVICE = ANSI.SYS 


When you are in V mode, you enter the following command at the 
system prompt: 


ANSI 


When you enter this command in V mode, you are actually executing 
ANSI.EXE, the ANSILSYS emulator for V mode. ANSIEXE installs 
itself in high memory. 


ANSISYS and ANSI.EXE escape sequences work in the same 
manner. Because some of the mode and graphics rendition settings do 
not apply to V mode, notes have been added to the following descrip- 
tions where necessary to explain these differences. If you do specify an 
unrecognized attribute or mode in ANSI.EXE, it is ignored. 


The default value is used when you do not specify an explicit value or 
when you specify zero. 
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Pn means numeric parameter. Pn is a decimal number specified with 
ASCII digits. 


Ps means selective parameter. Ps is any decimal number that selects a 


subfunction. You can select multiple subfunctions by separating the 
parameters with semicolons. 


C.1 Cursor Functions 


The following escape sequences affect the cursor position on the 
screen. 


CPR—Cursor Position Report (from console driver to system) 

ESC [ Pn; PnR 
The CPR sequence reports the current cursor position by way of stan- 
dard input. The first parameter specifies the current line; the second 


parameter specifies the current column. 


Note: CPR is not in ANSLEXE. 


CUB—Cursor Backward 

ESC [ Pn D 
This escape sequence moves the cursor back one column without 
changing lines. The value of Pn determines the number of columns 


moved. The default value for Pn is 1. The CUB sequence is ignored if 
the cursor is already in the far left column. 
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CUD—Cursor Down 

ESC [ Pn B 
This sequence moves the cursor down one line without changing 
columns. The value of Pn determines the number of lines moved. The 


default value of Pn is 1. The CUD sequence is ignored if the cursor is 
already on the bottom line. 


CUF—Cursor Forward 


ESC [Pn C 
The CUF sequence moves the cursor forward one column without 
changing lines. The value of Pn determines the number of columns 


moved. The default value for Pn is 1. The CUF sequence is ignored if 
the cursor is already in the far right column. 


CUP—Cursor Position 
ESC [PI ; Pc H 
HVP—Horizontal and Vertical Position 
ESC [PI ; Pc f 
CUP and HVP move the cursor to the position you specify with 
parameters. The first parameter specifies the line number; the second 


parameter specifies the column number. The default value is 1. If you 
do not specify any parameters, the cursor moves to the home position. 
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CUU—Caursor Up 

ESC [ PnA 
This sequence moves the cursor up one line without changing 
columns. The value of Pn determines the number of lines moved. The 


default value for Pn is 1. The CUU sequence is ignored if the cursor is 
already on the top line. 


DSR—Device Status Report 
ESC [n 


The console driver outputs a CPR sequence on receipt of the DSR 
escape sequence. 


RCP—Restore Cursor Position 
ESC [ u 


This sequence restores the cursor position to the value it had when the 
console driver received the SCP sequence (see below). 


SCP—Save Cursor Position 
ESC [ s 


The current cursor position is saved. This cursor position can be 
restored with the RCP sequence. 
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C.2 Erasing 


The following escape sequences affect erase functions. 


ED—Erase Display 
ESC [ J 


The ED sequence erases the screen, and the cursor goes to the home 
position. 


EL—Erase Line 
ESC [ K 


This sequence erases from the cursor position to the end of the line. 


C.3. Modes of Operation 


The following escape sequences affect screen graphics. 


RM—Reset Mode 


ESC [ = Ps 1 
or 

ESC [[ = 1 
or 

ESC [ = 01 
or 

ESC [?7 1 
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Parameters for RM are the same as for SM (Set Mode) except that 
parameter 7 resets the wrap at the end-of-line mode. 


Note: In V mode, when you are resetting mode parameters, only 
parameter 7 (no wrap at end of line) is recognized. 


SGR—Set Graphics Rendition 
ESC [Ps;..;Psm 


The SGR escape sequence invokes the graphics functions specified by 
the parameters described in Table C-1. The graphics functions remain 
in effect until the next occurrence of an SGR escape sequence. 


Note: In V mode, only the following attributes are recognized: 


All attributes off 
Bold on 
Underscore on 
Reverse video on 


“af © 
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ama PARAMETER FUNCTION 
0 All attributes off 
| Bold on 
4 Underscore on (monochrome displays only) 
5 Blink on 
7 Reverse Video on 
8 Concealed on (ISO 6429 standard) 
30 Black foreground (ISO 6429 standard) 
31 Red foreground (ISO 6429 standard) 
32 Green foreground (ISO 6429 standard) 
33 Yellow foreground (ISO 6429 standard) 
34 Blue foreground (ISO 6429 standard) 
35 Magenta foreground (ISO 6429 standard) 
36 Cyan foreground (ISO 6429 standard) 
37 White foreground (ISO 6429 standard) 
40 Black background (ISO 6429 standard) 
41 Red background (ISO 6429 standard) 
42 Green background (ISO 6429 standard) 
43 Yellow background (ISO 6429 standard) 
44 Blue background (ISO 6429 standard) 
45 Magenta background (ISO 6429 standard) 
ae 46 Cyan background (ISO 6429 standard) 
47 White background (ISO 6429 standard) 
SM—Set Mode 
ESC [ = Psh 
OT 
ESC [ = h 
or 
ESC [ = Oh 
or 
ESC [? 7h 


—_—_—_—_—_——— 


Table C-1: Set Graphics Rendition Escape Sequence Parameters 


The SM escape sequence changes the screen width or type to one of 
the parameters described in Table C-2. 
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Note: In V mode, only parameter 7 (wrap at end of line) is recognized. 


Table C-2: Set Mode Escape Sequence Parameters 


PARAMETER FUNCTION 


40 X 25 black and white 
40 X 25 color 

80 X 25 black and white 
80 X 25 color 

320 X 200 color 

320 X 200 black and white 
640 X 200 black and white 
Wrap at end of line 


“AMA BRWN — © 


C.4 Keyboard Reassignment 


Although not part of the ANSI 3.64-1979 or ISO 6429 standard, the 
following keyboard reassignments are compatible with these standards. 
The control sequence is: 
ESC [Pn; ... Pn p 
or 
ESC ["string” ; p 
or 
ESC [Pn ; “string” ; Pn ; Pn ; “string” ; Pn p 
or any other combination of strings and decimal numbers. 


The final code in the control sequence (p) is one reserved for private 
use by the ANSI 3.64-1979 standard. 


The first ASCII code in the control sequence defines which code is 
being mapped. The remaining numbers define the sequence of ASCII 
codes generated when this key is intercepted. There is one exception: if 
the first code in the sequence is zero (NUL), then the first and second 
codes make up an extended ASCII redefinition. 
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DEBUG 


Overview 


DEBUG is a debugging program that provides a controlled testing 
environment for binary and executable object files. DEBUG works on 
binary files in the same way a text editor works on source files. It lets 
you alter the contents of a file or CPU register, and then immediately 
reexecute a program to check the validity of the changes. DEBUG 
eliminates the need to reassemble a program to see if a problem has 
been fixed by a minor change. 


You can abort all DEBUG commands at any time by pressing CTRL- 
C. CTRL-S freezes the display, so that you can read it before the out- 
put scrolls away. Pressing any other key restarts the display. 


D.1 Using DEBUG 


You can start DEBUG using two methods. With method 1, you type 
all commands in response to the DEBUG prompt. With method 2, 
you type all commands at the same time. 


Table D-1: Methods to Start DEBUG 


METHOD COMMAND 
l DEBUG 
2 DEBUG [filespec [arglist]] 
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D.1.1 Method 1: Prompts 
To start DEBUG using method 1, type: 
DEBUG(cr) 


DEBUG responds with the hyphen (-) prompt, signaling that it is ready 
to accept your commands. Because you have not specified a filename, 
you can use other commands to work on current memory, disk 
sectors, or disk files. 


Warning: When DEBUG starts, it sets up a program header at offset 0 
in the program work area. On previous versions of DEBUG you could 
overwrite this header. You can still overwrite the default header if you 
do not specify a filespec. If you are debugging a .COM or .EXE file, 
however, do not tamper with the program header below address 5CH, 
or DEBUG terminates. 


Do not restart a program after the “Program terminated normally” 
message is displayed. You must reload the program with the N and L 
commands for it to run correctly. 


D.1.2 Method 2: Complete Command Line 
To start DEBUG using a command line, type: 
DEBUG [filespec [arglist]]}(cr) 


filespec is the file to be debugged, and arglist is the rest of the 
command that DEBUG uses when filespec is loaded into memory. 
arglist is a list of filename parameters and switches that you want 
passed to the program filespec. You can specify an arglist if you gave a 
filespec. Thus, when filespec is loaded into memory, it is loaded as if it 
had been started with the command filespec arglist. 
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If, for example, you type: 
DEBUG FILE.EXE(cr) 


DEBUG loads FILE.EXE into memory starting at 100 hexadecimal in 
the lowest available segment. The BX:CX registers load with the 
number of bytes placed into memory. 


D.2 Commands 


Each DEBUG command consists of a single letter followed by one or 
more parameters. You can use any combination of upper- and 
lowercase letters in commands and parameters. Note: The control 
characters and the special editing functions described in this book 
apply here. 


If you make a syntax error in a DEBUG command, DEBUG reprints 
the command line and indicates the error with an up-arrow (*) and the 
word “error.” For example: 


dcs:100 cs:110 


‘ error 


Table D-2 summarizes DEBUG commands. They are explained in 
detail, with examples, later in this section. 
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Table D-2: DEBUG Commands 


COMMAND FUNCTION 
A[address] Assemble 
C range address Compare 
D[range] Dump 
E address [list] Enter 
F range list Fill 
G[ = address [address...]] Go 
H value value Hex 
I value Input 
L[address [drive record record]] Load 
M range address Move 
N filename filename Name 
O value byte Output 
Q Quit 
R[register-name] Register 
S range list Search 
T[ = address][ value] Trace 
U[range] Unassemble 
W[address [drive record record]] Write 


All DEBUG commands except Quit accept parameters. You can 
separate parameters by delimiters (spaces or commas), but you must 
use a delimiter between two consecutive hexadecimal values. Thus, the 
following commands are equivalent: 


dcs:100 110 
d cs:100 110 
d,cs:100,110 
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Table D-3 defines DEBUG command parameters. 


Table D-3: Command Parameters 


PARAMETER DEFINITION 


drive A one-digit hexadecimal value that indicates which drive a file is 
loaded from or written to. These values designate drives as follows: 
O=A:;, 1=B:,2=C:,3=D:. 


byte A two-digit hexadecimal value placed in or read from an address or 
register. 
record A one- to three-digit hexadecimal value that indicates the logical 


record number on the disk and the number of disk sectors you want 
to write or load. Logical records correspond to sectors; however, 
their numbering differs because they represent the entire disk space. 


value A hexadecimal value of up to four digits that specifies a port 
number or the number of times a command should repeat its 
functions. 

address A two-part designation consisting of either an alphabetic segment 


register designation or a four-digit segment address and an offset 
value. The segment designation or segment address can be omitted; 
in these cases the default segment is used. 


DS is the default segment for all commands except G, L, T, U, and 
W. For these commands, the default segment is CS. All numeric 
values are hexadecimal. In these addresses, for example, you must 
put a colon between a segment designation (whether numeric or 
alphabetic) and an offset: | 


CS:0100 
04BA:0100 


range range consists of two addresses, an L, and a value, where value is the 
number of lines the command operates on, and L80 is assumed. 
You cannot use the last form if another hex value follows the range, 
since the hex value would be interpreted as the second address of 
the range. For example: 


CS:100 110 
CS:100 L 10 


This example is illegal: 


CS:100 CS:110 
“ error 


The limit for range is 10000 hex. To specify a value of 10000 
hex within four digits, type 0000 (or 0). 
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PARAMETER 


list 


string 
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DEFINITION 


A series of byte values or strings. list must be the last parameter on 
the command line. For example: 


fes:100 42 45 52 54 41 


Any number of characters enclosed in quotation marks. Quotation 
marks can be single (’) or double (”). If the delimiter quotation 
marks appear within a string, double the quotation marks. For 
example, the following strings are legal: 


This is a “string” is okay.’ 
However, this string is illegal: 
‘This is a ‘string’ is not.’ 
Similarly, these strings are legal: 


”This is a ‘string’ is okay.” 
”This is a ’”string”” is okay.” 


but this string is illegal: 
”This is a “string” is not.” 
Double quotation marks are not needed in the following strings: 


”This is a “string” is not necessary.” 
‘This is a ’”string’”’” is not necessary.’ 


The ASCII values of the characters in the string are used as a list of 
byte values. 
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Assemble (A) 


A[address] 
Assembles 8086/8087/8088 mnemonics directly into memory. 


All numeric values are hexadecimal and you must enter them as 1-4 
characters. Specify prefix mnemonics in front of the opcode to which 
they refer. You can also enter them on a separate line. 


The segment override mnemonics are CS:, DS:, ES:, and SS:. The 
mnemonic for the far return is RETF. String manipulation mnemonics 
must explicitly state the string size. For example, use MOVSW to 
move word strings, and MOVSB to move byte strings. 


The assembler automatically assembles short, near or far jumps and 
calls, depending on byte displacement to the destination address. You 
can override the defaults with the NEAR or FAR prefix. For example: 


0100:0500 JMP 502 ; a 2-byte short jump 
0100:0502 JMP NEAR 505 ; a 3-byte near jump 
0100:505 #=JMP FAR SOA ; a 5-byte far jump 


You can abbreviate the NEAR prefix to NE, but you cannot ab- 
breviate the FAR prefix. 


DEBUG cannot tell whether some operands refer to a word memory 
location or to a byte memory location. In these cases, you must ex- 
plicitly state the data type with the prefix WORD PTR or BYTE PTR. 
You can also use WO and BY. For example: 


NEG BYTE PTR [128] 
DEC WO [ST] 
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DEBUG also cannot tell whether an operand refers to a memory 
location or to an immediate operand. DEBUG uses the common 
convention that operands enclosed in square brackets refer to memory. 
For example: 


MOV AX,21 ; Load AX with 21H 
MOV AX, [21] ; Load AX with the contents 
of memory location 21H 


Assemble has two popular pseudo-instructions available. The DB 
opcode assembles byte values directly into memory. The DW opcode 
assembles word values directly into memory. For example: 


DB 1,2,3,4,"THIS IS AN EXAMPLE" 
DB 'THIS IS A QUOTE: "' 

DB "THIS IS A QUOTE: '" 

DW 1000, 2000, 3000, "BACH" 


Assemble supports all forms of the register indirect commands. For 
example: 


ADD BX, 34, [BP+2].[SI-1] 
POP [BP+DI ] 
PUSH [SI] 


Assemble also supports all opcode synonyms. For example: 


LOOPZ 100 
LOOPE 100 
JA 200 
JNBE 200 


For 8087 opcodes, you must explicitly specify WAIT or FWAIT. For 
example: 


FWAIT FADD ST,ST(3) ; This line will assemble an 
; FWAIT prefix 
LD TBYTE PTR [BX] ; This line will not 
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e 


Compare (C) 
C range address 


Compares the portion of memory specified by range to a portion of the 
same size beginning at address. 


If the two areas of memory are identical, there is no display and 
DEBUG returns with the MS-DOS prompt. Differences are displayed 
in this format: 


address1 byte1 byte2 address2 
These two commands have the same effect: 


C100,200 300 
C100L100 300 


Each command compares the block of memory from 100 to 1FFH 
with the block of memory from 300 to 3FFH. 


Dump (D) 
D[range] 
Displays the contents of the specified region of memory. 
If you specify a range of addresses, DEBUG displays the contents. If 
you type the D command without parameters, 128 bytes display at the 


first address (DS:100) after the address displayed by the previous 
Dump command. 
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The dump displays in two portions: a hexadecimal dump (each byte is 
shown in hexadecimal value) and an ASCII dump (the bytes are shown 
in ASCII characters). Nonprinting characters are indicated by a period 
(.) in the ASCII portion of the display. 


The display line shows 16 bytes with a hyphen between the eighth and 
ninth bytes. Each displayed line begins on a 16-byte boundary. 


If you type the command: 

dcs:100 110 
DEBUG displays: 

O4BA:0100 42 45 52 54 41 ... 4E 44 TOM SAWYER 
If you type the following command: 

D 
DEBUG displays 128 bytes. Each line of the display begins with an 
address, incremented by 16 from the address on the previous line. 
Each subsequent D (without parameters) displays the bytes imme- 
diately following those last displayed. 
If you type the command: 


DCS:100 L 20 


the display is formatted as described above, but 20H bytes are dis- 
played. 


If you then type the command: 
DCS:100 115 


the display is formatted as described above, but all the bytes in the 
range from 100H to 115H in the CS segment display. 
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Enter (E) 


E address[ list] 


Enters byte values into memory at the specified address. 


If you type the optional list of values, DEBUG automatically replaces 
the byte values. If an error occurs, no byte values are changed. 


If you type the address without the list, DEBUG displays the address 
and its contents, then repeats the address on the next line and waits for 
your input. At this point the Enter command waits for you to do one 
of the following: 


l 


. Replace a byte value with another value by typing the value after 


the current value. If the value you type is not a legal hexadecimal 
value, or if you enter more than two digits, DEBUG does not echo 
the illegal or extra character. 


. Press the Space bar to advance to the next byte. To change the 


value, enter the new value after the current value. If you space 
beyond an 8-byte boundary, DEBUG starts a new display line with 
the address displayed at the beginning. 


. Type a hyphen (-) to return to the preceding byte. If you decide to 


change a byte behind the current position, type the hyphen to return 
the current position to the previous byte. When you type the 
hyphen, a new line is started with the address and its byte value 
displayed. 


. Press the Return key to terminate the Enter command. You can 


press the Return key at any byte position. 
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Assume you enter the following command: 
ECS:100 
DEBUG displays: 
O4BA:0100 EB. _ 
To change this value to 41, type 41 as shown: 
04BA:0100 EB.41_ 
To step through the subsequent bytes, press the Space bar to see: 
O4BA:0100 EB.41 10. OO. BC. _ 
To change BC to 42, type: 


04BA:0100 EB.41 10. 00. BC.42_ 


Now, to change 10 to 6F, type the hyphen as many times as needed to 
return to byte 0101 (value 10). Then replace 10 with 6F: 


O4BA:0100 EB.41 10. 00. BC .42- 


04BA:0102 00.-_ 
04BA:0101 10.6F_ 


Press Return to end the Enter command and return to the DEBUG 
command level. 
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Fill (F) 
F range list 
Fills the addresses in the range with values in the list. 


If the range contains more bytes than the number of values in the list, 
the list is used repeatedly until all bytes in the range are filled. If the list 
contains more values than the number of bytes in the range, the extra 
values in the list are ignored. If any of the memory in the range is not 
valid (bad or nonexistent), the error occurs in all succeeding locations. 


Assume you type the following command: 
FO4BA:100 L 100 42 45 52 54 41 
DEBUG fills memory locations 04BA:100 through 04BA:1FF with the 


bytes specified. The five values are repeated until all 100H bytes are 
filled. 


Go (G) 
G[ = address[ address...]] 
Executes the program currently in memory. 


If you type only the Go command, the program runs as it would 
outside DEBUG. 


If you set =address, execution begins at the address specified. The 


equals sign (=) is required, so that DEBUG can distinguish the start 
= address from the breakpoint addresses. 
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When the other optional addresses set, execution stops at the first 
address encountered, regardless of that address’s position in the list of 
addresses to halt execution or program branching. When program 
execution reaches a breakpoint, the registers, flags, and decoded in- 
struction display for the last instruction executed. The result is the 
same as if you had entered the Register command for the breakpoint 
address. 


You can set up to ten breakpoints. Breakpoints must be set, however, 
only at addresses containing the first byte of an 8086-88 opcode. If you 
set more than ten breakpoints, DEBUG returns the BP error message. 
See the end of this appendix for a list of DEBUG error messages. 


The user stack pointer must be valid and have 6 bytes available for this 
command. The Go command uses an IRET instruction to cause a 
jump to the program under test. The user stack pointer is set, and the 
user flags, Code Segment register, and Instruction Pointer are pushed 
on the user stack. Thus, if the user stack is not valid or is too small, 
MS-DOS can crash. DEBUG places an interrupt code (OCCH) at the 
specified breakpoint address(es). 


When DEBUG encounters an instruction containing the breakpoint 
code, all breakpoint addresses are restored to their original in- 
tructions. If execution does not halt at one of the breakpoints, the 
interrupt codes are not replaced with the original instructions. 


Assume you type the following command: 
GCS:7550 


The program currently in memory executes up to the address 7550 in 
the CS segment. DEBUG then displays registers and flags, and the Go 
command terminates. 


After DEBUG encounters a breakpoint, you can type the Go 
command again and the program executes just as if you had typed the 
filename at the MS-DOS command level. The only difference is that 
program execution begins at the instruction after the breakpoint rather 
than at the usual start address. 
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Hex (H) 

H value value 
Performs hexadecimal arithmetic on the two parameters specified. 
DEBUG adds the two parameters and subtracts the second parameter 
from the first. The results of the arithmetic display on a single line: first 
the sum, then the difference. 
If you type the command: 

H19F 10A 


DEBUG performs the calculations and then displays results: 


O2ZA9 0095 


Input (I) 
| value 
Inputs and displays one byte from the port specified by value. 
This command allows a 16-bit port address. 
Assume you type the following command: 
I2F8 


Assume also that the byte at the port is 42H. DEBUG inputs the byte 
and displays the value 42. 
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Load (L) 


L[address [drive record record]] 
Loads a file into memory. 


Sets BX:CX to the number of bytes read. The file loaded must already 
be named. Name the file either when you start DEBUG or with the N 
command. Both the DEBUG invocation and the N command format 
a filename properly in the normal format of a file control block at 
CS:5C. 


If you type the L command without any parameters, DEBUG loads 
the file into memory beginning at address CS:100 and sets BX:CX to 
the number of bytes loaded. If you type the L command with an 
address parameter, loading begins at the memory address specified. 


If you type L with all the parameters, DEBUG loads absolute disk 
sectors instead of a file. The records are taken from the drive specified. 
The drive designation is numeric here—O=A:, 1=B:, 2=C:. 
DEBUG begins loading with the first record specified, and continues 
until the number of sectors specified in the second record are loaded. 


Assume you type the following commands: 


A> DEBUG 
-NFILE.COM 


To load FILE.COM, type L. DEBUG loads the file and displays the 
DEBUG prompt. To load portions of a file or certain records from a 
disk, type: 


LO4BA:100 2 OF 6D 
DEBUG then begins with logical record number 15 and loads 109 (6D 


hex) records into memory beginning at address 04BA:0100. When the 
records are loaded, DEBUG returns the hyphen prompt. 
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If the file has an .EXE extension, it is relocated to the load address 
specified in the header of the .EXE file: the address parameter is always 
ignored for .EXE files. The header itself is stripped off the .EXE file 
before it is loaded into memory. Thus, the size of an .EXE file on disk 
differs from its size in memory. 


If the named file is a .HEX file, typing the L command with no 
parameters tells DEBUG to load the file beginning at the address 
specified in the .HEX file. If the L command includes the option 
address, DEBUG determines the start address by adding the address 
specified in the L command to the address found in the .HEX file. 


Move (M) 
M range address 


Moves the block of memory specified by range to the location 
beginning at the address specified. 


DEBUG always performs overlapping moves. Overlapping moves are 
where part of the block overlaps some of the current addresses without 
loss of data. Addresses that could be overwritten are moved first. When 
you want to move from higher addresses to lower addresses, this 
command moves the data beginning at the block’s lowest address and 
then works toward the highest. When you want to move from lower 
addresses to higher addresses, DEBUG moves the data beginning at the 
block’s highest address and works toward the lowest. 


The M command actually copies data rather than moves it. If you do 
not plan to write new data to the addresses in the block you are 
moving, the existing data remains intact. Consequently, the sequence 
of the move Is important. 
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Assume that you type: 
MCS:100 110 CS:500 


DEBUG first moves data from address CS:110 to address CS:510, then 
CS:10F to CS:50F, and so on until CS:100 is moved to CS:500. You 
can review the results of the move by typing the D command, with the 
same address you typed for the M command. 


Name (N) 


N filename [filename] 
Sets file names. 


The Name command performs two functions: 


1. Name assigns a filename for a later Load or Write command. Thus, 
if you start DEBUG without naming a file to debug, you must type 
the N filename command before a file can be loaded. 


2. Name assigns filename parameters to the file you are debugging. In 
this case, Name accepts a list of parameters that are used by the file 
being debugged. 


These two functions overlap. Consider the following set of DEBUG 
commands: 


-NFILE1.EXE 


-L 
-G 
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These commands result in four steps: 


1. (N)ame assigns the filename FILE1.EXE to the filename used in any 
later Load or Write commands. 


2. (N)ame also assigns the filename FILE1.EXE to the first filename 
parameter used by any program that is later debugged. 


3. (L)oad loads FILE1.EXE into memory. 


4. (G)o executes FILE1.EXE with FILE1.EXE as the single filename 
parameter, that is, FILE1.EXE is executed as if FILE1.EXE had 
been typed at the command level. 


A more useful chain of commands might be: 


-NFILE1.EXE 

-L 

-NFILE2.DAT FILE3.DAT 
-G 


Here, Name sets FILE1.EXE as the filename for the subsequent Load 
command. The Load command loads FILE1.EXE into memory, and 
then the Name command is used again, this time to specify the 
parameters used by FILE1.EXE. Finally, when the Go command is 
executed, FILE1.EXE executes as 1f you had typed FILE! FILE2.DAT 
FILE3.DAT at the MS-DOS command level. 


If DEBUG executes a Write command at this point, then 
FILE1.EXE—the file that is being debugged— is saved with the name 
FILE2.DAT. To avoid these results, always execute a Name command 
before either a Load or a Write command. 


The Name command can affect four regions of memory: 
CS:5C FCB for file 1 


CS:6C FCB for file 2 
CS:80 Count of characters 
CS:8 1 All characters typed 
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DEBUG sets up a File Control Block (FCB) for the first filename 
parameter you gave at CS:5C. If you type a second filename 
parameter, you set up an FCB beginning at CS:6C. The number of 
characters you type, exclusive of the first character, ‘“‘N’’, is given at 
location CS:80. The actual stream of characters given by the command 
(again, exclusive of the letter ‘““N’’) begins at CS:81. 


This stream of characters might contain switches and delimiters that 
would be legal in any command typed at the MS-DOS command level. 


A typical use of the Name command is: 
DEBUG PROG.COM 
-NPARAM1 PARAM2/C 
-G 


In this example, the Go command executes the file in memory as if 
you had typed the following command line: 


PROG PARAM1 PARAM2/C 


Output (O) 

O value byte 
Send the byte specified to the output port specified by value. 
This command allows a 16-bit port address. 


If you type O2F8 4F, DEBUG outputs the byte value 4F to output 
port 2F8. 
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Quit (Q) 

Q 
Terminates the DEBUG utility. 
The Q command takes no parameters and exits DEBUG without 
saving the file you are currently working on. You are returned to the 
MS-DOS command level. 
To end the debugging session, type: 


Q 


DEBUG terminates and control returns to the MS-DOS command 
level. 


Register (R) 
R[register-name] 
Displays the contents of one or more CPU registers. 


If you do not type register-name, the R command dumps the register 
save area and displays the contents of all registers and flags. 


If you type a register name, the 16-bit value of that register displays in 
hexadecimal and a colon appears as a prompt. You can then either 
type a value to change the register, or, if you do not want any changes, 
press Return. 
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The only valid register names are: 


AX DI PC 
BP DX SI 
BX ES SP 
CS F SS 
CX IP SX 


(IP and PC both refer to the Instruction Pointer.) 


Any other entry for register-name results in a BR error message. See 
the end of this appendix for a list of DEBUG error messages. 


If you enter F as the register-name, DEBUG displays each flag with a 
two-character alphabetic code. To alter any flag, type the opposite 
two-letter code. The flags are either set or cleared. 


Table D-4 lists the flags with their codes for SET and CLEAR. 


Table D-4: Register Flag Codes 


FLAG NAME SET CODE CLEAR CODE 
Overflow OV NV 

Direction DN (Decrement) UP (Increment) 
Interrupt EI (Enabled) DI (Disabled) 
Sign NG (Negative) PL (Plus) 

Zero ZR NZ 

Auxiliary Carry AC NA 

Parity PE (Even) PO (Odd) 
Carry CY NC 


Whenever you type the RF command, the flags display in a row at the 
beginning of a line, in the order shown in Table D-4. At the end of the 
list of flags, DEBUG displays a hyphen (-). You can enter new flag 
values as alphabetic pairs, in any order. You do not have to leave 
spaces between the flag entries. 
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To exit the R command, press the Return key. Any flags for which you 
did not enter new values remain unchanged. 


If you enter more than one value for a flag; DEBUG returns a DF 
error message. If you enter a flag code other than those shown in Table 
D-4, DEBUG returns a BF error message. In both cases, flags up to the 
error in the list are changed; those flags at and after the error are not. 


At startup, the segment registers are set to the bottom of free memory, 
the Instruction Pointer is set to 0100H, all flags are cleared, and the 
remaining registers are set to zero. 


If you type: 
R 


DEBUG displays all registers, flags, and the decoded instruction for the 
current location. If the location is CS:11A, the display looks similar to 
this: 


' AX=OEOO BX=OO0OFF CX=0007 DX=01FF SP=039D BP=0000 
SI=005C DI=0000 DS=04BA ES=04BA SS=04BA CS=04BA 
IP=Oll1A NV UP DI NG NZ AC PE NC 


O4BA:011A CD21 INT 21 
If you type: 

RF 
DEBUG displays the flags: 


NV UP DI NG NZ AC PE NC - _ 


Now type any valid flag designation, in any order, with or without 
spaces. For example: 


NV UP DI NG NZ AC PE NC - PLEICY 
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DEBUG responds only with the DEBUG prompt. To see the changes, 
type either the R or RF command: 


RF 
DEBUG displays: 
NV UP EI PL NZ AC PE CY - _ 


Press Return to leave the flags this way, or to specify different flag 
values. 


Search (S) 


S range list 
Searches the range specified for the list of bytes specified. 
The list can contain one or more bytes, each separated by a space or 
comma. If the list contains more than one byte, only the first address 
of the byte string is returned. If the list contains only one byte, all 
addresses of the byte in the range are displayed. 
If you type: 

SCS:100 110 41 
DEBUG responds with: 

O4BA:0104 


04BA:010D 
—type: 
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Trace (T) 


T[ = address][ value] 


Executes one instruction and displays the contents of the decoded in- 
struction and all registers and flags. 


If you type the optional =address, DEBUG traces at the address 
specified. The optional value tells DEBUG to execute and trace the 
number of steps specified by value. 


The T command uses the hardware trace mode of the 8086 or 8088 
microprocessor. Consequently, you can also trace instructions stored in 
ROM, read-only memory. : 


If you type: 
T 


DEBUG returns a display of the registers, flags, and decoded 
instruction for that one instruction. Assume that your current position 
is 04BA:011A; DEBUG might return the display: 


AX=OQEOO BX=OOFF CX=0007 DX=O1FF SP=039D BP=0000 
SI=005C DI=0000 DS=04BA ES=04BA SS=04BA CS=04BA 
IP=011A NV UP DI NG NZ AC PE NC 
O4BA:011A CD21 INT 21 


If you type: 
T=011A 10 


DEBUG executes sixteen (10 hex) instructions beginning at 011A in 
the current segment, and then displays all registers and flags for each 
instruction as it is executed. The display scrolls until the last in- 
struction is executed. Then the display stops, and you can see the 
register and flag values for the last few instructions performed. 
Remember that CTRL-S suspends the display at any time, so that you 
can study the registers and flags for any instruction. 
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Unassemble (U) 
U[range] 


Disassembles bytes and displays the source statements that correspond 
to them, with addresses and byte values. 


The display of disassembled code looks like a listing for an assembled 
file. If you type the U command without parameters, DEBUG 
disassembles 20 hexadecimal bytes at the first address after that 
displayed by the previous Unassemble command. If you type the U 
command with the range parameter, then DEBUG disassembles all 
bytes in the range. If the range is given as an address only, then 20H 
bytes are disassembled instead of 80H that the Dump command would 
default to. 


If you type: 
U04BA:100 L10 
DEBUG disassembles 16 bytes beginning at address 04BA:0100: 


04BA:0100 206472 AND’ [SI+72], AH 


O4BA:0103 69 DB 69 

04BA:0104 7665 JBE O16B 

O4BA :0106 207370 AND’ [BP+DI+'70],DH 
04BA:0109 65 DB 65 

O4BA:010A 63 DB 63 

O4BA:010B 69 DB 69 

O4BA:010C 66 DB 66 

04BA:010D 69 DB 69 

04BA:010E 63 DB 63 

O4BA:010F 61 DB 61 


If you enter: 


U04BA:0100 0108 
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The display shows: 


04BA:0100 206472 AND’ [SI+72],AH 
04BA:0103 69 DB 69 

04BA:0104 7665 JBE O16B 
04BA:0106 207570 AND [BP+DI+70],DH 


If you change bytes in some addresses, the disassembler alters the in- 
struction statements. You can type the U command for the changed 
locations, the new instructions viewed, and the disassembled code used 
to edit the source file. 


Write (W) 
W[address[ drive record record]] 
Writes the file being debugged to a disk file. 


If you type W with no parameters, BX:CX must already be set to the 
number of bytes to be written; the file is written beginning from 
CS:100. If you type the W command with just an address, DEBUG 
writes the file beginning at that address. 


If you use a G or T command, BX:CX must be reset before you use 
the Write command without parameters. Note that if DEBUG loads 
and modifies a file, the name, length, and starting address are all set 
correctly to save the modified file, as long as the length has not 
changed. 


The file must be named either with the DEBUG invocation command 
or with the N command. Both the DEBUG invocation and the N 
command format a filename properly in the normal format of a file 
control block at CS:5C. 
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If you use the W command with parameters, DEBUG writes the file 
beginning from the memory address specified. The file is written to the 
specified drive (the drive designation is numeric here—0O =A, | =B, 
2 =C, and so on) beginning at the logical record number specified by 
the first record. DEBUG continues until the number of sectors 
specified in the second record are written. 


Note: Writing to absolute sectors is extremely dangerous because the 
process bypasses the file handler. 


If you type: 

W 
DEBUG writes the file to disk and then displays the DEBUG prompt: 
If you type: 


WwW 
CS:100 1 37 2B 


DEBUG writes out the contents of memory, beginning with the 
address CS:100, to the disk in drive B. The data written out starts at 
logical record number 37H and consists of 2BH records. When the 
write is finished, DEBUG displays the prompt: 


WCS:100 1 37 2B 
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D.3. Debug Error Messages 


You might see any of the following error messages during a DEBUG 
(eo session. Each error terminates DEBUG command under which it 
occurs, but it does not terminate DEBUG itself. 


ERROR CODE DEFINITION 


BF Bad flag: You attempted to alter a flag, but the 
characters typed were not one of the acceptable 
pairs of flag values. See the Register command 
for the list of acceptable flag entries. 


BP Too many breakpoints: You specified more than 
ten breakpoints as parameters to the Go com- 
mand. Retype the Go command with ten or 
fewer breakpoints. 


BR Bad register: You typed the R command with an 
invalid register name. See the Register command 
for the list of valid register names. 


DF Double flag: You typed two values for one flag. 
You can specify a flag value only once per RF 
command. 
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Index 


.BAT, 2-10, 3-8 

.BIN, 6-46 

.CHR, 6-74 

.COM, 2-2, 3-8, 6-46 

.EXE, 2-2, 3-8, 6-46 

.KB, 6-74 

5 3-4 

wey Je4 

? wild-card, 2-6 to 2-8 

* wild-card, 2-6 to 2-8 

<, 5-11 to 5-14, 6-8, 6-120 to 6-122 

>, 5-11 to 5-14, 6-8, 6-27, 6-120 to 
6-122 

>>, 5-13, 6-8 

| 5-12 to 5-14, 6-7, 6-120 to 6-122 

*, 6-8 

+, 6-29 to 6-32 

\, 3-3, 3-4, 3-13, 3-16, 6-7, 6-72 to 6-73 

/, 3-3, 6-7, 6-15 

=, 6-116 to 6-117 

= =, 6-63, 6-68, 6-118 to 6-119 

(cr), 6-8 

(sp), 6-8 


allocation units, 6-22 to 6-23 
ANSI escape sequences, Appendix C 
cursor functions, C-2 to C-4 
erasing, C-4 
keyboard reassignment, C-8 
screen graphics, C-5 to C-8 
ASCII 
collating sequence, 5-10, 6-120 
conversion table, Appendix A 
ASSIGN, 6-17 to 6-18 
AUTOEXEC.BAT, 2-13 to 2-14, 6-36, 
6-67 


Index 


AVAILDEV, 6-11 


batch commands, list of, 6-6 


ECHO, 6-44 to 6-45 
FOR-IN-DO, 6-59 to 6-60 
GOTO, 6-62 to 6-64 
IF-EXIST, 6-68 to 6-70 
PAUSE, 6-86 

REM, 6-96 

SHIFT, 6-118 to 6-119 


batch file, 2-2, 2-10 to 2-13, 6-118 to 


6-119 

aborting, 6-86 

AUTOEXEC.BAT, 2-13 to 2-14, 
6-36, 6-67 

conventions for, 2-11 

echoing, 6-44 to 6-45 

filtering and piping, 5-14 

invoking, 2-11 

processing, 6-44 

remarks in, 6-96 

replaceable parameters, 2-11 to 2-12, 
6-62 to 6-64, 6-118 to 6-119 


batch processing, 6-118 to 6-119 


aborting, 6-86 

IF/GOTO in, 6-62 to 6-64 
invoking, 2-11 

replaceable parameters, 6-62 to 6-64 
shifting parameters, 6-118 to 6-119 


binary file, 6-46 to 6-47 
boot process, 6-9 
BREAK, 6-11, 6-18 
BUFFERS, 6-12 


CAUX, 6-33 to 6-34 
CHDIR, 3-15 to 3-16, 6-19 to 6-20 
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CHKDSK, 6-21 to 6-24 
CLS, 6-24 
CLST, 6-33 to 6-34 
color graphics, 6-64 
command editing, 5-1 to 5-10 
command files, 1-2 to 1-3, 2-2, 
Chapter 6 
command interface illustration, 6-4 
command line editing 
in I mode, 5-3 to 5-6 
in V mode, 5-6 to 5-10 
command processor, 6-3, 6-14 to 6-15, 
6-66 to 6-67, 6-128 
command prompt, I-11 
command syntax, 6-6 to 6-8 
symbols in, 6-7 to 6-8 
COMP, 6-25 to 6-26 
CONCAT, 6-27 
concatenation, 6-27, 6-29 to 6-32 
configuration commands, 6-9 to 6-16 
configuration file, 6-9 to 6-10, 6-16 
COPY, 3-7, 6-28 to 6-33, 6-43 
+ symbol in, 6-29 to 6-32 
concatenation in, 6-30 to 6-33 
COUNTRY, 6-12 
country codes, 6-12 
cross-linked files, 6-23 
CTRL-C system interrupt, 6-11, 6-18 
CTTY, 6-33 to 6-34 


data file, filtering and piping, 5-13, 6-81 
DATE, 6-35 to 6-36 
date stamping, 1-8 to 1-9, 6-35 
DEBUG, Appendix D 
command parameters, D-5 to D-6 
command summary, D-4 
commands, D-7 to D-28 
error codes and messages, D-29 
loading methods, D-2 
parameter definition, D-5 to D-6 
register flag codes and names, D-22 
DEL, 3-7, 6-36 to 6-37 
DEVICE, 6-13 
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assignments, 6-87 
changing, 6-33 to 6-34 
errors, Appendix B 
installation, 6-9, 6-13 
I/O errors, Appendix B 
names, 2-8 to 2-9 
device drivers, 2-8, 6-9, 6-13 
DIR, 3-8 to 3-9, 6-37 to 6-39 
directory, 1-7, 3-1, 6-37 to 6-39 
changing, 3-15 to 3-16, 6-19 to 6-20 
creating, 3-10 to 3-14, 6-72 to 6-73 
hierarchy, Chapter 3, 6-21 
listing, 3-8 to 3-9, 6-37 to 6-39, 
6-70 to 6-71 
listing multiple, 6-134 
names, 3-3 to 3-5 
naming conventions, 3-10 
removing, 3-17, 6-99 to 6-100 
sample listing, 6-38 
sorting, 6-120 to 6-122 
disk 
comparing, 6-39 to 6-41 
copying, 6-41 to 6-43 
formatting, 6-61 to 6-62 
fragmented disk space, 6-43 
Victor format, 1-3, 6-98, 6-98 
Disk Operating System, see MS-DOS 
disk space, |-7 
DISKCOMP, 6-39 to 6-41 
DISKCOPY, 6-41 to 6-43 
drive names, 2-2 to 2-5 


ECHO, 6-44 to 6-45 
editing keys, using, 5-1 to 5-10 
EDLIN line editor, Chapter 4 

file commands, 4-5 to 4-23 

file command parameters, 4-6 
ERASE, 6-36 to 6-37, 6-45 
error messages, Chapter 7, Appendix B 
Escape sequences, ANSI, Appendix C 
EXE2BIN, 6-46 to 6-47 
executable file, 6-46 
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EXESIZE, 6-47 to 6-48 
EXIT, 6-48 
external commands, 3-8, 6-3, 6-5 


F1 key, 5-3, 5-7 

F2 key, 5-3, 5-7 

F3 key, 5-3, 5-7 

F4 key, 5-3, 5-7 

FS key, 5-3, 5-7 

F6 key, 5-3, 5-7 

F7 key, 5-7 

FAT, see file allocation table 

FGREP, 6-49 to 6-51 

FILCOM, 6-51 to 6-55 

file 
binary, 6-46 to 6-47 
concatenation, 6-27, 6-29 to 6-32 
copying, 3-7, 6-28 to 6-33 
cross-linked, 6-23 
definition of, 2-1 to 2-2 
deleting, 3-7, 6-36 to 6-37 
displaying on screen, 3-6, 6-128 
executable, 6-46 to 6-47 
extensions, 2-3 to 2-4 
hidden, 1-2 to 1-4 
linker-generated, 6-46 to 6-47 
listing, 6-70 to 6-71, 6-134 
moving, 6-82 to 6-83 
names, 2-2 to 2-9 
printing, 6-87 to 6-92 
recovering, 6-95 
renaming, 6-97 
system, 1-2 to 1-4 
time stamping, 1-10 to 1-11, 6-124 
types of, 2-1 to 2-2 

file allocation table (FAT), 1-7, 6-22, 

6-95 

file extension, 2-3 to 2-4, 2-6 

FILES, 6-14 

filtering, 5-10 to 5-14, 6-56 to 6-58, 

6-81, 6-120 to 6-122 
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filtering and piping 

batch files, 5-14 

columnar files, 5-14 

data files, 5-13 
FIND, 5-11, 6-56 to 6-58, 6-120 
FOR-IN-DO, 6-59 to 6-60 
FORMAT, 6-61 to 6-62 
function keys, editing with, 5-3 to 5-10 


GOTO, 6-62 to 6-64 
GRAPHICS, 6-64 


hexadecimal conversion table, 
Appendix A 

hidden files, 1-4 

hierarchical subdirectories, see 
subdirectory 

HISTORY, 6-65 to 6-66 


I mode, 1-1, 1-5, 1-11 

editing in, 5-3 to 5-6 

library, 1-5 
ICOMMAND, 6-66 to 6-67 
ICOMMAND.COM, 1-4, 1-6 to 1-7, 6-3, 

6-14, 6-66 to 6-67 

ICONFIG.SYS, 1-6, 6-9 to 6-10, 6-15 
IDOS.SYS, 1-2, 1-4 
IF-EXIST, 6-68 to 6-70 
internal commands, 6-3 to 6-5 
I/O devices, changing, 6-33 to 6-34 
I/O errors, Appendix B 


libraries, subdirectory, 1-5 
line editing commands, 5-1 to 5-10 
line editor (EDLIN), Chapter 4 
loading MS-DOS, 1-8 

date stamping, 1-8 to 1-9 

time stamping, 1-10 to 1-11 
LS, 6-70 to 6-71 


MKDIR, 3-10 to 3-14, 6-72 to 6-73 


MODCON, 6-74 to 6-76 
MODE, 6-79 to 6-80 
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MORE, 5-14, 6-81 

MS-DOS 
boot process, 6-9 
command editing, 5-1 to 5-10 
command files, 1-2 to 1-3 
definition, 1-1 
disk space, division, 1-7 
installation, 1-8, 6-9 to 6-10 
memory management, 1-6 
messages, Chapter 7 
operation modes, 6-77 to 6-80 
prompt, 1-11, 6-92 to 6-94 
system configuration, 1-8, 6-9 to 6-16 
system files, 1-1 to 1-2, 6-98 to 6-99 
system structure, 1-1 to 1-5 
version of, 6-129 

MV, 6-82 to 6-83 


operation modes, setting, 6-77 to 6-80 


PATH, 3-8, 6-84 to 6-85 

paths, Chapter 3, 6-5, 6-84 to 6-85 
listing with TREE, 6-125 to 6-127 
names, 3-4 to 3-5 

PAUSE, 6-86 

piping, 5-12 to 5-14, 6-56 to 6-58, 6-81, 

6-120 to 6-122 

PRINT, 6-87 to 6-92 

PROMPT, 1-11, 6-92 to 6-94 

prompt, MS-DOS, 1-11 
changing, 6-92 to 6-94 


RECOVER, 6-95 

REM, 6-96 

REN, 6-97 

replaceable parameters, 2-11 to 2-12, 
6-62 to 6-64, 6-118 to 6-119 

RETROSYS, 6-98 to 6-99 

RMDIR, 3-17, 6-99 to 6-100 

root directory, 3-1, 3-4, 6-19 
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SDCOPY, 6-101 to 6-102 
SEARCH, 6-103 to 6-115 
action and constraint modifiers, 
6-112 
action switches, 6-109 to 6-111 
matching constraints, 6-104 to 6-109 
SET, 6-116 to 6-117 
SHELL, 6-14 to 6-15 
SHIFT, 6-118 to 6-119 
SORT, 5-11 to 5-12, 5-14, 6-120 to 
6-122 
subdirectory 
changing, 3-15 to 3-16, 6-19 to 6-20 
creating, 3-10 to 3-14, 6-72 to 6-73 
libraries, 1-5 
listing, 3-8 to 3-9 
naming conventions, 3-10 
removing, 3-17, 6-99 to 6-100 
structure, 1-5 
system, Chapter 3 
SWITCHAR, 6-15 to 6-16 
symbols, 6-7 to 6-8 
? wild-card, 2-6 to 2-8 
* wild-card, 2-6 to 2-8 
.» a-4 
wy 3-4 
\, 3-3, 3-4, 3-13, 3-16, 6-7, 6-72 
/, 3-3, 6-15 
<, 5-11 to 5-14, 6-8, 6-120 to 6-122 
> , 3-11 to 5-14, 6-8, 6-27, 6-120 to 
6-122 
>> , 5-13, 6-8 
| 5-12 to 5-14, 6-7, 6-120 to 6-122 
*, 6-8 
+ , 6-29 to 6-32 
=, 6-116 to 6-117 
= =, 6-63, 6-68 
(cr), 6-8 
(sp), 6-8 
system configuration commands, 6-9 to 
6-16 
system diskette, 1-5, 1-8 
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system files, 1-1 to 1-2, 1-4, 2-2 
copying, 6-98 to 6-99 
system interrupt, 6-11, 6-118 
system prompt, I-11 
changing, 6-92 to 6-94 
system resources, 1-4 


TAIL, 6-123 

TIME, 6-124 to 6-125 

time stamping, 1-10 to 1-11, 6-124 
TREE, 6-125 to 6-127 

TYPE, 3-6, 5-13, 6-128 


V mode, I-1, 1-5, 1-11 
editing in, 5-6 to 5-10 
library, 1-5 
VCOMMAND, 6-15, 6-128; see 
ICOMMAND 
VCOMMAND.COM, 1-4, 1-6 to 1-7, 
6-3, 6-14, 6-66 to 6-67, 6-128 
VCOMFIG:SYS, 1-6, 2-8, 6-9 to 6-10, 
6-15 
VDOS.SYS, 1-2, 1-4 
VER, 6-129 
VERIFY, 6-130 
VOL, 6-131 to 6-132 
Volume ID label, 6-131 to 6-132 


WC, 6-132 to 6-134 
wild-card characters, 2-6 to 2-8 
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